Description des options générales
Ce module est disponible à partir des versions postérieures au 20260507
Plusieurs interfaces ui_element acceptent une table d’options permettant d’indiquer l’application cible, le nombre de résultats, la profondeur de récursion, la vérification de détection et le pas de défilement.
Options de requête
local options = {
pid = app.front_pid(),
max_level = 2,
max_elements = 200,
include_hit_state = true,
}
- pid
type entier, identifiant de processus de l’application cible. En l’absence de valeur, l’application au premier plan est généralement utilisée. - max_level
type entier, profondeur de récursion des éléments enfants. Les valeurs1ou2sont couramment utilisées pour contrôler la quantité de données renvoyées. - max_elements
type entier, nombre maximal d’éléments de premier niveau renvoyés. - fallback_children
type booléen, tente de lire les éléments enfants lorsque la liste ordinaire est vide. La valeur par défaut varie selon l’interface. - include_hit_state
type booléen, indique s’il faut compléter les champs de l’état de détection. - hit_test
type booléen, indique s’il faut activer la détection par échantillonnage de l’écran. Les scripts ordinaires n’ont généralement pas besoin de l’activer. - fallback_hit_test
type booléen, indique s’il faut tenter la détection par échantillonnage lorsque la liste ordinaire est vide. - hit_test_spacing
type numérique, espacement des échantillons à l’écran, en coordonnées logiques. 40 par défaut.
Options d’exclusion d’attributs
Disponibles à partir de 20261115. Uniquement pour snapshot() et list_text_elements(). Toutes sont booléennes, valent false par défaut et s’appliquent aussi aux éléments enfants. Si ces états ne sont pas nécessaires, activer les options d’exclusion peut réduire le coût des requêtes et accélérer la capture des instantanés.
- exclude_visibility
Avectrue, ignore les requêtes de visibilité et ometisVisible. - exclude_map
Avectrue, ignore la vérification de l’attribut de carte et ometisMap; les éléments de carte sont conservés. - exclude_hit_state
Avectrue, ignore les vérifications de hit au point central et ometcanHit,hitVerified,hitTestPointethitTestPointLogical. Ne peut pas être combinée avecinclude_hit_state = true.
L’ensemble des éléments, le texte, les coordonnées et les règles de recherche complémentaire d’éléments de hit_test / fallback_hit_test restent inchangés. N’excluez pas un champ d’état si vous devez filtrer selon ce champ.
Options d’action
- point
type table, point utilisé pour le défilement ou la détection, par exemple{ x = 200, y = 700 }, en pixels physiques. - x / y
type entier, équivalents depoint, pouvant être placés directement dans la table d’options. - steps
type numérique, paramètre de pas utilisé pour les opérations de défilement, d’augmentation ou de diminution. L’effet exact dépend du contrôle cible.
Description
list_text_elements()est plus conservatrice par défaut pour assurer la compatibilité avec les anciens scripts.find(),find_all(),snapshot()et les interfaces d’action conviennent mieux à une utilisation directe dans les nouveaux scripts.hit_testpeut renvoyer un élément plus proche de la couche supérieure actuelle de l’interface, mais son coût est plus élevé ; il est recommandé de ne l’utiliser que si une requête ordinaire ne trouve aucun élément.